Saltar al contenido principal

Wiki.js v2.x – Documentación Técnica

Wiki.js es un moderno sistema de gestión de contenido de código abierto (CMS) diseñado para crear documentación colaborativa y wikis internas. Desarrollado por Requarks, se caracteriza por su rendimiento, diseño moderno, soporte multilingüe y arquitectura modular.

🧩 Versión analizada​

  • Versión: 2.x (rama estable y ampliamente utilizada)

⚙️ Requerimientos técnicos​

Wiki.js es una aplicación basada en Node.js, por lo que es altamente portable y puede ejecutarse en casi cualquier sistema moderno. A continuación, se detallan los requerimientos mínimos y recomendados:

✅ Sistemas operativos compatibles​

Wiki.js puede instalarse en cualquier sistema donde Node.js sea soportado:

  • Linux (distribuciones como Ubuntu, Debian, CentOS, etc.)
  • Windows
  • macOS
  • Docker (disponible imagen oficial en Docker Hub)

🔧 Docker es recomendado para facilitar la instalación, aislamiento y portabilidad.

✅ Requisitos de hardware​

RecursoMínimo recomendadoNotas
CPU2 núcleos (cores) o másProcesos de renderizado y actualización se benefician de múltiples núcleos
RAM1 GB mínimo en LinuxEn Windows/macOS se recomienda más (2GB o más)
Almacenamiento1 GB o másDepende del contenido de tu Wiki

🌐 Requerimientos de red y dominio​

🌍 Dominio/Subdominio​

Wiki.js requiere estar montado en un subdominio dedicado (por ejemplo: wiki.midominio.com). No se puede alojar en una subcarpeta del dominio principal (como midominio.com/wiki).

Esto se debe a cómo gestiona las rutas internas y las cabeceras en la aplicación, lo que garantiza mayor estabilidad y compatibilidad con servicios como OAuth, SAML o proxies inversos (NGINX, Traefik, etc.).

💾 Base de datos​

Wiki.js necesita una base de datos relacional para funcionar. Aunque admite múltiples motores (como MySQL o MSSQL), se recomienda ampliamente el uso de PostgreSQL por ser el más robusto y compatible.

  • Versión mínima recomendada: PostgreSQL 9.5 o superior
  • Método de conexión requerido: Usuario y contraseña

📌 No se permite acceso sin autenticación o mediante sockets locales sin credenciales.

🔧 Node.js – Requisitos de versión​

Wiki.js requiere Node.js como entorno de ejecución. Las versiones oficialmente compatibles y soportadas son las siguientes:

Versión Node.jsCompatible desde
22.xv2.5.302
20.xv2.5.300
18.xv2.5.300

⚠️ Las versiones impares de Node.js (por ejemplo, 19.x, 21.x, 23.x) no son oficialmente compatibles.

Asegúrate de utilizar una de las versiones pares listadas para garantizar estabilidad y compatibilidad con las dependencias internas del sistema.

⚠️⚠️⚠️⚠️⚠️ Alerta ⚠️⚠️⚠️⚠️⚠️​

🔄 Sistema de actualizaciones automáticas​

Wiki.js verifica automáticamente si existen nuevas actualizaciones del sistema y de los paquetes de idioma.

  • Frecuencia: cada 24 horas
  • Servicios de actualización:
    • Sistema: Nuevas versiones del software
    • Lenguaje: Actualizaciones de traducciones

🔐 Privacidad en las solicitudes​

Estas solicitudes se realizan hacia graph.requarks.io, el servicio oficial en la nube mantenido por los desarrolladores.

  • No se envía información privada del contenido de tu Wiki
  • No se rastrean datos personales
  • Únicamente se envía:
    • Tu dirección IP pública
    • Datos de la solicitud (ej. versión del software, idioma solicitado)
  • No se almacena la información después de procesarse

🛡️ Esto cumple con buenas prácticas de privacidad y transparencia en software de código abierto.

📚 Recursos adicionales​